home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / fatal142.zip / FATAL.DOC next >
Text File  |  1990-04-22  |  8KB  |  227 lines
  1.  
  2.                               F A T A L
  3.                    Resident Critical Error Handler
  4.  
  5.                              FATAL14.ZIP
  6.                             v1.4 04-22-90
  7.  
  8.                  Copyright 1989, 1990 Samuel H. Smith
  9.                           All rights reserved.
  10.  
  11.  
  12. This program is a resident (TSR) utility that traps critical errors and
  13. attempts to handle them in an intelligent way.  It replaces the normal
  14. "Retry, Ignore, Abort" prompt.  The program automatically attempts to
  15. retry failed operations when you are not there to press the "R" key.
  16.  
  17. It draws on all available information to present a complete error
  18. description to the user.  If the operator does not respond within 10
  19. seconds the program will automatically take the action suggested by DOS.
  20.  
  21. DOS version 3.0 or later is required to use this program.
  22. Once resident, FATAL used about 3800 bytes of RAM.
  23.  
  24.  
  25. Usage:
  26.    FATAL/I     ;install FATAL in memory.
  27.  
  28.    FATAL/U     ;un-install, remove FATAL from memory.
  29.  
  30.    FATAL/C     ;display critical error counters.
  31.  
  32.    FATAL/Z     ;reset error counters to zero.
  33.  
  34.  
  35. The FATAL program will take over critical errors that are not directly
  36. handled in a later program.  It is careful to preserve any replacement
  37. error handler used by an application program.  Because of this, it is
  38. advised to load FATAL as an early TSR, before any others that also set
  39. up critical error handlers.  In multi-tasking systems you may need to
  40. load a copy of FATAL into each memory partition.
  41.  
  42.   NOTE: If you are running the LANtastic network, you must load FATAL
  43.         *before* calls to SERVER and probably also before REDIR and
  44.         LANBIOS. Otherwise a sharing violation will be trapped on the
  45.         server rather than on the offending workstation!
  46.  
  47. Example output
  48. --------------
  49.  
  50. FATAL/I
  51.    FATAL v1.4 installed.
  52.  
  53. FATAL/U
  54.    FATAL unInstalled.
  55.  
  56. FATAL/C
  57.    FATAL v1.4 status:
  58.       10 Critical errors.
  59.        5 Automatic retries.
  60.    Error:
  61.        3 Seek error!
  62.        6 Sharing violation!
  63.        1 Network device no longer exists!
  64.    Class:
  65.        3 Hardware failure
  66.        6 Resource locked
  67.        1 Unknown
  68.    Locus:
  69.        1 Unknown.
  70.        8 Block device (disk error).
  71.        1 Network.
  72.    Drive:
  73.        2 I:
  74.        6 J:
  75.        2 U:
  76.    Area:
  77.        5 Directory area.
  78.        5 Data area.
  79.    Suggested action:
  80.        3 Retry the operation.
  81.        6 Delay and then retry.
  82.        1 Re-enter input.
  83.  
  84.  
  85.   ╔═══════════════════╡ CRITICAL ERROR! ╞════════════════════╗                  
  86.   ║  Error: Drive not ready!                                 ║                  
  87.   ║  Area:  Reading from drive A: File allocation table.     ║                  
  88.   ║  Class: Hardware failure in Block device (disk error).   ║                  
  89.   ║  Suggested action: Retry after correcting the error.     ║                  
  90.   ╚══════════════════════════════════════════════════════════╝                  
  91.      Action: (A)bort, (R)etry, (I)gnore, (F)ail? <R>
  92.  
  93. FATAL/Z
  94.    Critical error counters zeroed.
  95.  
  96.  
  97.                                    LICENSE
  98.                                    =======
  99.  
  100.    SourceWare: What is it?
  101.    -----------------------
  102.  
  103.    SourceWare is my name for a unique concept in user supported
  104.    software.
  105.  
  106.    Programs distributed under the SourceWare concept always offer source
  107.    code.
  108.  
  109.    This package can be freely distributed so long as it is not modified 
  110.    or sold for profit.  If you find that this program is valuable, you
  111.    can send me a donation for what you think it is worth.  I suggest
  112.    about $10.
  113.  
  114.    Send your registrations to:        The Tool Shop BBS
  115.       Samuel H. Smith                 (602) 264-3969 (2400) - Free node
  116.       5119 N. 11th Ave., #332         (602) 279-2673 (HST 9600)
  117.       Phoenix AZ 85013                (602) 279-0230 (HAYES 9600)
  118.  
  119.  
  120.    Why SourceWare?
  121.    ---------------
  122.    Why do I offer source code?  Why isn't the donation manditory?  The
  123.    value of good software should be self-evident.  The source code is
  124.    the key to complete understanding of a program.  You can read it to
  125.    find out how things are done.  You can also change it to suit your
  126.    needs, so long as you do not distribute the modified version without
  127.    my consent.
  128.  
  129.  
  130.    Copyright
  131.    ---------
  132.    If you modify this program,  I would appreciate a copy of the new
  133.    source code.  I am holding the copyright on the source code,  so
  134.    please don't delete my name from the program files or from the
  135.    documentation.
  136.  
  137.  
  138.                                 DISCLAIMER
  139.                                 ==========
  140.    I make no warranty of any kind, express or implied, including without
  141.    limitation, any warranties of merchantability and/or fitness for a
  142.    particular purpose.  I shall not be liable for any damages, whether
  143.    direct, indirect, special or consequential arising from a failure of
  144.    this program to operate in the manner desired by the user.  I shall
  145.    not be liable for any damage to data or property which may be caused
  146.    directly or indirectly by the use of this program.
  147.  
  148.    IN NO EVENT WILL I BE LIABLE TO YOU FOR ANY DAMAGES, INCLUDING ANY
  149.    LOST PROFITS,  LOST SAVINGS OR OTHER INCIDENTAL OR CONSEQUENTIAL
  150.    DAMAGES ARISING OUT OF YOUR USE OR INABILITY TO USE THE PROGRAM, OR
  151.    FOR ANY CLAIM BY ANY OTHER PARTY.
  152.  
  153.  
  154.  
  155. Revision History
  156. ----------------
  157.  
  158. 7-20-89 v1.0
  159.    Initial coding and release.
  160.  
  161.  
  162. 7-31-89 v1.1
  163.    Changed all display code to use BIOS calls exclusively.  The initial
  164.    version used the DOS function 9, but this caused problems when
  165.    standard output was redirected: the FATAL messages were also
  166.    redirected!
  167.  
  168.    Added screen save and restore operations; original user screen is now
  169.    preserved after fatal error processing (text modes only).  BIOS calls
  170.    are used for compatibility with all system types.
  171.  
  172.    Corrected an error that caused application program error handlers to
  173.    be replaced.  FATAL is supposed to replace only the standard handler,
  174.    leaving application error handlers in place.
  175.  
  176.  
  177. 8-2-89 v1.2
  178.    Changed keyboard input functions to use BIOS calls rather than DOS
  179.    calls.  This prevents a crash if standard input has been redirected
  180.    from a file at the time a critical error takes place.
  181.  
  182.    Slight reduction in RAM requirement.
  183.  
  184.    FATAL now removes itself from memory if run a second time.  Please
  185.    don't do this if you have any resident programs loaded after FATAL.
  186.  
  187.    Added /L command line option to bypass license messages.
  188.  
  189.  
  190. 8-14-89 v1.3
  191.    Added internal counters for number of critical errors and number of
  192.    automatic retries.  Each possible error message is counted for later
  193.    reporting.
  194.  
  195.    New FATAL/C option produces a detailed report of all error counters.
  196.  
  197.    New FATAL/I option performs initial installation.
  198.  
  199.    New FATAL/U option un-installs fatal if possible.
  200.  
  201.    Fatal now hooks the DOS services interrupt in addition to the timer
  202.    tick interrupt.  On very fast machines it was possible to miss a
  203.    critical error during the first 55 miliseconds of program execution.
  204.  
  205.  
  206. 12-26-89 v1.4ß1
  207.    Shortened automatic retry delay from 30 seconds to 10 seconds.
  208.  
  209.    New FATAL/Z option to zero all error counters.
  210.  
  211.    Added new logic to properly handle nested calls to COMMAND.COM and
  212.    shells to COMMAND.COM from application programs.
  213.  
  214.    Improved the ability of FATAL/C to locate the resident portion, even
  215.    when being called by an application that takes over the critical
  216.    error interrupt.
  217.  
  218.  
  219. 03-29-90 v1.4ß2
  220.    Added some additional error messages.
  221.  
  222.    Corrected "stray" character in prompt.
  223.  
  224.    Widened error display window to allow better formatting of longer
  225.    error reports.
  226.  
  227.